home *** CD-ROM | disk | FTP | other *** search
/ 8bitfiles.net/archives / archives.tar / archives / canada-remote-systems / c128 / graphutl / gds.sfx / gds docs.txt < prev    next >
Text File  |  1990-08-26  |  11KB  |  248 lines
  1.                   ╟╥┴╨╚╔├╙ ╔╬╘┼╥├╚┴╬╟┼ ╞╧╥═┴╘ ─╔╙╨╠┴┘ ╙┘╙╘┼═
  2.  
  3.  
  4. ├OPYRIGHT ╬OTICES AND OTHER SUCH STUFF....
  5.  
  6. '╟╔╞' AND '╟RAPHICS ╔NTERCHANGE ╞ORMAT' ARE TRADEMARKS OF ├OMPU╙ERVE, ╔NC., AN
  7. ╚&╥ ┬LOCK ├OMPANY. (YOU KNOW... THE GUYS WHO YOU GIVE MONEY TO FOR TELLING YOU
  8. HOW MUCH MONEY YOU WILL GIVE TO THE ╟OVERNMENT.)
  9.  
  10. ┬┴╙╔├ 8 IS A TRADEMARK OF ╫ALRUS ╙OFTWARE, ╔NC.
  11.  
  12. ╘HE ╟RAPHICS ╔NTERCHANGE ╞ORMAT ─ISPLAY ╙YSTEM, OR ╟╔╞ ─ISPLAY ╙YSTEM FOR
  13. SHORT, OR BETTER YET - ╟─╙ (MAINLY BECAUSE IT'S CATCHY, BUT ALSO BECAUSE ╔
  14. REALLY DON'T WANT TO TYPE OUT THE WHOLE THING), IS ╬╧╘ ╨UBLIC ─OMAIN.  ╘HIS
  15. PROGRAM CANNOT BE SOLD WITHOUT THE EXPRESS WRITTEN CONSENT OF THE AUTHOR (ME).
  16. ╘HIS PROGRAM MAY BE DISTRIBUTED FREELY AS LONG AS ALL ORIGINAL FILES ARE
  17. INCLUDED WITH IT.
  18.  
  19. ╟─╙ FALLS UNDER THE CATEGORY OF ╞╥┼┼╫┴╥┼.  ┴LL ╔ WANT FOR THIS IS THE FAME,
  20. GLORY, RECOGNITION, AND POSTCARDS.  ┘EP, YOU READ RIGHT! ╨╧╙╘├┴╥─╙.  ╔ KINDA
  21. COLLECT POSTCARDS, AND ╔ WOULD ALSO LIKE TO SEE HOW FAR THIS PROGRAM GETS
  22. DISTRIBUTED.  ╙O IF YOU USE THIS PROGRAM REGULARLY, YOU ARE OBLIGATED TO SEND
  23. ME A POSTCARD.  ╔ GUESS YOU CAN CALL THIS ╨╧╙╘├┴╥─╫┴╥┼!!!!!
  24. ╨LEASE SEND EVERYTHING YOU WANT TO SEND ME TO:
  25.  
  26.                              ┼RIC ├. ╥AFANAN
  27.                              ╨.╧. ┬OX 1428
  28.                              ─UNNELLON, ╞╠ 32630
  29.  
  30. ╘HIS INCLUDES POSTCARDS, COMMENTS, PICTURES FROM CUTE GIRLS, OFFERS FOR ├┼╧
  31. POSITIONS (ONLY FROM PROMINENT COMPANIES PLEASE), OR BETTER YET - ╟╔╞S! ╔ ONLY
  32. HAVE A SMALL COLLECTION AND ┴╬┘╘╚╔╬╟ (YES - ┴╬┘╘╚╔╬╟) WOULD BE APPRECIATED.
  33.  
  34. ┴NYWAY, ON WITH THE DOCS...
  35.  
  36.  
  37. ╟╔╞ ─ISPLAY ╙YSTEM
  38.  
  39.  
  40. ┴FTER USING THE ╟╔╞╞┘ PROGRAM FOR THE ├64 BY ╩OHN ╥. ╫IND, ╔ WAS IMPRESSED. ╔
  41. ALSO THOUGHT THAT ANYTHING THE ├64 CAN DO, THE ├128 CAN DO BETTER. ╙O ╔ SET OUT
  42. TO WRITE A ├128 ╟╔╞ ─ISPLAY PROGRAM THAT WAS EASIER TO USE, YET PRODUCED BETTER
  43. DISPLAYS.
  44.  
  45. ╙O HERE IT IS.
  46.  
  47. ╘HE PROGRAM ACTUALLY CONSISTS OF SEVERAL FILES:
  48.  
  49. 1) ╟─╙          - ╘HIS IS THE ═AIN ═ODULE OF THE ╟─╙ PROGRAM.
  50.                   ╔T LOADS IN THE 2 SUPPORT MODULES, HANDLES THE CHOOSING OF
  51.                   THE ╟╔╞, THE INTERPRETATION OF THE ╟╔╞ HEADER, AND THE ACTUAL
  52.                   DECOMPRESSION OF THE COMPRESSED RASTER DATA.
  53.  
  54. 2) ╟─╙.─┼╞┴╒╠╘╙ - ╘HIS FILE CONTAINS THE NAMES OF THE DEFAULT SUPPORT MODULES.
  55.  
  56. 3) ╟─╙.─/????   - ╞ILES WITH THIS PREFIX ARE ─ISPLAY ═ODULE FILES.
  57.                   ╟─╙ WAS WRITTEN TO BE MODULAR TO ALLOW DIFFERENT DISPLAY
  58.                   FORMATS TO BE USED.
  59.  
  60. 4) ╟─╙.╪/????   - ╞ILES WITH THIS PREFIX ARE ┼XTENSION ╚ANDLER ═ODULES.
  61.                   ╟╔╞ FILES HAVE THE OPTION TO INCLUDE 'UPDATES' IN THE FORM
  62.                   OF ┼XTENSION ┬LOCKS, AND THE ┼XTENSION ╚ANDLER ═ODULE TAKES
  63.                   CARE OF THESE BLOCKS.
  64.  
  65. ==============================================================================
  66.  
  67. ╘HE ═AIN ═ODULE
  68.  
  69. ╘HE ╟─╙ PROGRAM HAS BEEN WRITTEN FOR EASE OF USE. ┴LMOST EVERYTHING CAN BE DONE
  70. THROUGH THE USE OF MENUS.
  71.  
  72. ╒SE THE ├URSOR ╦EYS TO HIGHLIGHT A CHOICE.
  73. ╒SE THE ╥ETURN ╦EY TO PICK IT.
  74. ╒SE THE ┼╙├ ╦EY TO ABORT ALMOST ANYTHING (THE PROGRAM WILL TELL YOU WHEN IT
  75. DOES SOMETHING ELSE).
  76.  
  77. ═OST OF THE MENUS ARE SELF-EXPLANATORY, SO ╔ WILL ONLY COVER THOSE AREAS THAT
  78. MAY NEED A LITTLE MORE CLARIFICATION.
  79.  
  80. ╘HE ═AIN ═ENU HAS 3 CHOICES:
  81.  
  82. 1) ╓IEW A ╟╔╞    - ┴LLOWS YOU TO VIEW A ╟╔╞ ON ─RIVES 8, 9, 10, OR 11.
  83.                    ┘OU CHOOSE THE ╟╔╞ FROM A ─IRECTORY LISTING.
  84.                    ╬╧╘┼ - ╟╔╞S MUST BE ╨ROGRAM, ╙EQUENTIAL, OR ╒SER (THOUGH
  85.                           NON-╟┼╧╙) TYPE FILES.
  86.  
  87. 2) ┼XIT          - ╨RETTY SELF-EXPLANATORY.
  88.  
  89. 3) ╙ELECT ═ODULE - ┴LLOWS YOU TO SELECT ANOTHER ─ISPLAY ═ODULE OR ┼XTENSION
  90.                    ═ODULE FROM ─RIVES 8, 9, 10, OR 11.
  91.                    ┴LSO MAKES IT THE ─EFAULT ═ODULE AS AN OPTION.
  92.                    ╬╧╘┼ - ╫HEN YOU WRITE A NEW ─EFAULTS FILE, BOTH THE ├URRENT
  93.                           ─ISPLAY ┴╬─ ┼XTENSION ═ODULES ARE MADE THE ─EFAULTS.
  94.  
  95. ┴LL THE SECONDARY MENUS ARE ╥┼┴╠╠┘ SELF-EXPLANATORY (┘┼╙/╬╧, ├HOOSE A ─RIVE,
  96. ETC.) SO ╔ DON'T THINK ╔ NEED TO GO INTO THEM (AFTER ALL, IF YOU OWN A ├128,
  97. THEN YOU'VE ╟╧╘ TO HAVE ABOVE AVERAGE INTELLIGENCE!).
  98.  
  99.  
  100. ╘HE ╙CREEN ╠AYOUT
  101.  
  102.  
  103. ╘HE ╙CREEN IS DIVIDED INTO 3 PARTS:
  104.  
  105. 1) ├REDIT ┬LOCKS - ╘HIS IS THE UPPER HALF OF THE SCREEN. ╘HE TWO SMALLER BLOCKS
  106.                    ARE CREDITS READ FROM THE ═ODULES (SO IF YOU'RE WILLING TO
  107.                    PROGRAM A ═ODULE, YOU CAN LET PEOPLE KNOW WHO DID IT! ╔T'S
  108.                    ONLY FAIR AFTER ALL.).
  109.  
  110. 2) ╟╔╞ ╔NFO      - ╘HE LOWER LEFT PORTION OF THE SCREEN IS USED TO DISPLAY
  111.                    INFORMATION ABOUT THE ╟╔╞ YOU HAD CHOSEN.  ═OST OF IT NEEDS
  112.                    NO EXPLANATION, BUT HERE'S ONE THING TO WATCH OUT FOR -
  113.                    ╔ BELIEVE THERE HAS BEEN AN UPDATE TO THE ╟╔╞ FORMAT. ╔T
  114.                    HAS BEEN LABELED '╟╔╞89A'.  ╟─╙ RECOGNIZES ANY ╟╔╞ WITH THE
  115.                    '╟╔╞' SIGNATURE, BUT IT ═┴┘ NOT PROCESS '89A' TYPE ╟╔╞S
  116.                    CORRECTLY.  ═OST ╟╔╞S ARE CURRENTLY '╟╔╞87A'.
  117.  
  118. 3) ═ESSAGE ┴REA  - ╘HE LOWER RIGHT PORTION OF THE SCREEN IS THE ═ESSAGE ┴REA.
  119.                    ╘HIS IS WHERE MOST (IF NOT ALL) USER INTERACTION WILL TAKE
  120.                    PLACE.
  121.  
  122.  
  123. ┴ND THAT'S ALL THERE IS TO IT!
  124.  
  125. ==============================================================================
  126.  
  127. ╟ETTING ╘HIS ╘HING ╥UNNING
  128.  
  129.  
  130. ╘HE BASIC STEPS TO USING THIS PROGRAM ARE:
  131.  
  132. ╥╒╬ "╟─╙" ╧╬ ╒(WHATEVER)
  133.   (IT WILL LOAD, RUN, THEN LOAD IN THE ─EFAULT ═ODULES FROM THE ├URRENT ─RIVE)
  134.  
  135. ├HOOSE '╓IEW A ╟╔╞' FROM THE ═AIN ═ENU.
  136.  
  137. ╨ICK THE ─RIVE THE ╟╔╞S ARE ON.
  138.   (IT WILL THEN READ IN ALL FILENAMES WITH THE '.╟╔╞' SUFFIX)
  139.  
  140. ╚IGHLIGHT AND ├HOOSE THE ╟╔╞ YOU WANT TO VIEW.
  141.  
  142. ├ONFIRM YOUR ╙ELECTION.
  143.   (YOU CAN ABORT IF ALL YOU WANTED TO DO WAS LOOK AT THE ╟╔╞ INFO)
  144.  
  145. ┴ND AWAY IT GOES!!!
  146.  
  147. ==============================================================================
  148.  
  149. ╘HE ─ISPLAY ═ODULE
  150.  
  151.  
  152. ╘HE ─ISPLAY ═ODULE IS THE PART OF THE SYSTEM THAT (YOU GUESSED IT!) ACTUALLY
  153. DISPLAYS THE ╟╔╞.  ╔T ALSO IS RESPONSIBLE FOR DOING THE COLOR TRANSLATIONS.
  154. ╔ CHOSE TO MAKE IT A MODULE SO THAT DIFFERENT FORMATS COULD BE CHOSEN WITHOUT
  155. ACTUALLY REWRITING THE ENTIRE PROGRAM.  ╘HESE FORMATS CAN INCLUDE 40-COLUMN
  156. ╚I-╥ES AND ═ULTICOLOR GRAPHICS SCREENS, ┬ASIC 8 FORMATS, THE ╔╨AINT FORMAT, OR
  157. EVEN CUSTOM MADE FORMATS.  ┴LL IT TAKES IS THE CORRECT ─ISPLAY ═ODULE.
  158.  
  159. ╘HE ═AIN ═ODULE TAKES CARE OF EVERYTHING (INCLUDING DECOMPRESSING THE RASTER
  160. DATA - THAT WAS A TOUGHIE!) EXCEPT ACTUALLY PUTTING THE PICTURE ON THE SCREEN,
  161. SO IT'S NOT HARD TO COME UP WITH A NEW ─ISPLAY ═ODULE.  ╞OR ANY PROGRAMMERS WHO
  162. ARE INTERESTED, ╔ WILL BE UPLOADING ╨ROGRAMMING ╬OTES '╥EAL ╙OON ╬OW'. (╞AMOUS
  163. ╠AST ╫ORDS!)
  164.  
  165. ╘HERE ARE 3 ─ISPLAY ═ODULES INCLUDED WITH THE ╟─╙ PROGRAM:
  166.  
  167. 1) ╟─╙.─/╬╧╥═┴╠    - ╘HIS IS THE ─EFAULT ═ODULE. ╔T IS SET TO PROVIDE A PRETTY
  168.                      GOOD DISPLAY FOR THE MAJORITY OF THE ╟╔╞S.
  169.  
  170. 2) ╟─╙.─/╠╔╟╚╘┼╥   - ╔F THE ╟╔╞S SEEM TO BE COMING OUT TOO DARK (ALOT OF 256
  171.                      COLOR ╟╔╞S TEND TO), THEN THIS MODULE WILL ATTEMPT TO
  172.                      MAKE THE COLORS BRIGHTER.
  173.  
  174. 3) ╟─╙.─/─┴╥╦┼╥    - ╘HIS MODULE IS SET TO DARKEN THE COLORS IN A ╟╔╞.
  175.  
  176. ┴LL 3 REQUIRE 64╦ OF ╓─├ ╥┴═.
  177.  
  178. ╘HESE ─ISPLAY ═ODULES WERE CODED FOR 16-COLOR ╟╔╞S, BUT 4 AND 32-COLOR ╟╔╞S
  179. STILL SHOW UP PRETTY GOOD.  ╬OW 256-COLOR ╟╔╞S ARE ANOTHER MATTER...
  180.  
  181. ╙INCE THE ├128 HARDWARE ONLY SUPPORTS 16 COLORS, THEN TO GET ANY REASONABLE
  182. DISPLAY OF 256 COLORS REQUIRES SOME FORM OF ╙╧╞╘╫┴╥┼ WORKAROUND, SUCH AS
  183. DITHERING OR INTERLACE (LIKE IN ╔╨AINT - GOSH, ╔ WISH ╔ HAD THE ╔╨AINT
  184. FORMAT!).  ┴NYWAY, THE ─ISPLAY ═ODULES THAT COME WITH THE ╟─╙ PROGRAM ARE
  185. PRETTY SAD WHEN IT COMES TO 256-COLOR ╟╔╞S (AND THAT'S COMING FROM THE PERSON
  186. WHO PROGRAMMED THEM!).
  187.  
  188. ╘HE ─ISPLAY ═ODULES WILL 'STRETCH' OR 'SQUASH' A ╟╔╞ TO FIT INTO THE 640X200
  189. ┬ASIC 8 FORMAT.  ╔T CAN HANDLE ╔NTERLACED ╟╔╞ FILES UP TO A HEIGHT OF 200
  190. LINES.
  191.  
  192. ┴FTER VIEWING THE ╟╔╞, HITTING ANY KEY EXCEPT FOR THE '╙' KEY WILL RETURN YOU
  193. TO THE ═AIN ═ODULE.
  194.  
  195. ╘HE '╙' KEY ALLOWS YOU TO SAVE THE ╟╔╞ AS A 640X200 8X2-COLOR BLOCK ┬ASIC 8
  196. PICTURE.  ┴FTER HITTING THE '╙' KEY, YOU WILL HEAR 2 QUICK BELLS TO NOTIFY YOU
  197. THAT SAVING HAS BEGUN. ╫HEN IT IS DONE, YOU WILL BE RETURNED TO THE ═AIN ═ENU.
  198.  
  199. ╘HE PICTURE WILL BE SAVED ON THE SAME DISK AS THE ╟╔╞ SO BE SURE THAT THERE IS
  200. ENOUGH ROOM ON THE DISK FOR IT (TYPICALLY 50-80 DISK BLOCKS).  ╘HE NEW FILE
  201. WILL HAVE THE SAME NAME AS THE ╟╔╞ WITH THE ADDITION OF THE '╨╔├╘.' PREFIX AND
  202. NO '.╟╔╞' SUFFIX.
  203.  
  204.       **** ─╧ ╬╧╘ ╥┼═╧╓┼ ┴╬┘ ─╔╙╦╙ ╫╚╔╠┼ ╘╚┼ ╟╥┼┼╬ ╠╔╟╚╘ ╔╙ ╧╬! ****
  205.  
  206. ╘HIS MEANS YOU CANNOT CHANGE DISKS BEFORE SAVING THE PICTURE (ACTUALLY YOU CAN,
  207. BUT YOU'LL GET A DISK ERROR AFTERWARDS).  ╘HIS IS A SHORTCOMING OF THE ─ISPLAY
  208. ═ODULE WHICH IS CURRENTLY BEING WORKED ON.
  209.  
  210. ==============================================================================
  211.  
  212. ╘HE ┼XTENSION ╚ANDLER ═ODULE
  213.  
  214.  
  215. ╘HE ┼XTENSION ╚ANDLER ═ODULE HANDLES ╟╔╞ ┼XTENSION ┬LOCKS.  ╘HESE ┼XTENSION
  216. ┬LOCKS ARE USED TO IMPLEMENT SPECIAL FUNCTIONS, GIVE EXTRA ╟╔╞ INFO, ETC. THAT
  217. ARE NOT PROVIDED FOR IN THE STANDARD ╟╔╞ FORMAT.  ╘HE ┼XTENSION ╚ANDLER ═ODULE
  218. PROVIDED JUST IGNORES THESE ┼XTENSION ┬LOCKS.  ┴CTUALLY, ╔ HAVEN'T FOUND ANY
  219. ╟╔╞S WITH ┼XTENSION ┬LOCKS AT ALL!  ╔F YOU DO, LET ME KNOW IF THE ┼XTENSION
  220. ┬LOCK ╚ANDLER WORKS, EH?  (╙ORRY ABOUT THIS FOLKS, BUT YOU CAN'T TEST SOMETHING
  221. IF THERE'S NOTHING TO TEST IT WITH!)
  222.  
  223. ==============================================================================
  224.  
  225. ╔F YOU FIND ANY PROBLEMS WITH THIS PROGRAM, PLEASE LET ME KNOW.  ╔ REALLY HAVE
  226. TRIED TO SQUASH ALL THE BUGS, BUT MY SUPPLY OF ╟╔╞S TO TEST WITH IS ╓┼╥┘
  227. LIMITED.  ╙O IF YOU FIND ANYTHING WRONG, ╔ WON'T TAKE IT TOO PERSONALLY.
  228.  
  229. ╒NFORTUNATELY, MY LAWYERS TELL ME TO INFORM YOU THAT ╔ CAN'T BE HELD
  230. RESPONSIBLE FOR ANY DAMAGE INCURRED THROUGH THE USE OF THIS PROGRAM.  ╬OT THAT
  231. THERE'S ANY CHANCE OF THAT MIND YOU - NONE OF MY EQUIPMENT HAS BEEN DAMAGED AND
  232. IT WAS USED TO ╘┼╙╘ THIS PROGRAM!  ╔ ─╔─ HAVE A PROBLEM WHILE WRITING THE
  233. DECOMPRESSION ROUTINE THOUGH - ╔ THINK ╔ DEVELOPED A NEW ART FORM!  ╔ ALSO
  234. THINK ╔ SUFFERED BRAIN DAMAGE LOOKING AT IT! <JUST KIDDING - REALLY!>
  235. ┴NYWAY, ABOUT THE ONLY WAY YOU COULD DO DAMAGE TO ANYTHING IS IF YOU GET SO
  236. OVERWHELMED BY THE INCREDIBLE PICTURES BEING DISPLAYED THAT YOU FALL OVER
  237. BACKWARDS AND STARTLE THE CAT WHO JUMPS ONTO YOUR DESK AND SPILLS YOUR DRINK
  238. ALL OVER YOUR COMPUTER!  ┘OU SHOULDN'T HAVE HAD THAT DRINK THERE ANYWAY...
  239.  
  240. ╫ELL THAT'S ABOUT IT FOR THE DOCUMENTATION.  ╔ HOPE ╔ DIDN'T LEAVE OUT TOO MUCH
  241. BUT THE PROGRAM IS PRETTY EASY TO RUN ANYWAY.
  242.  
  243.                              ┼NJOY!
  244.                               ┼RIC ├. ╥AFANAN
  245.                                ╤LINK: ═E┼RIC
  246.  
  247. ├OPYRIGHT 1990
  248. ┴LL ╥IGHTS ╥ESERVED